home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / System 7 / TrashMan 4.05 / TrashMan 4.0.5 Docs < prev    next >
Text File  |  1993-09-09  |  13KB  |  179 lines

  1.  
  2.  
  3.  
  4. by Dan Walkowski, 1993
  5. VERSION 4.0.5, 8/31/1993
  6.  
  7. **TrashMan, TM, Emptier and the TrashMan Truck are ©1993 by Dan Walkowski.  I retain all rights to this software.  It may not be included in any shareware 'packages' without my express written consent.  TrashMan may be given/transmitted/mailed and otherwise distributed freely, as long as no fee is charged, and as long as this document accompanies it.**
  8.  
  9. A small list of organizations have my authorization to distribute TrashMan:
  10. For authorization, please contact me at the address below.
  11.  
  12. NOTE:
  13. TrashMan is NOT free.  TrashMan is shareware.  TrashMan will make your System 7 trashcan behave the way it ought to, and might save you hours of lost work.  Isn’t that worth a few dollars?
  14. If you use it, please send $10.00 to:
  15.  
  16.           Dan Walkowski
  17.           140 Pasito Terrace #512
  18.           Sunnyvale, CA  94086
  19.           email:  walkowsk@taurus.apple.com
  20. (For site license information, please contact me.)
  21.  
  22. In addition, if you have some sort of Net access, (GEnie, InterNet, BitNet, CompuServe, AOL, etc.), please send along your address, so that I can get in touch with you if necessary.
  23.  
  24. Paying your registration fee will entitle you to use all possible future versions of TrashMan freely. (Not to mention that your feature requests will receive higher priority).
  25. Additionally, if you include a floppy disk with your payment, you will either get the latest version (if you do not have it) or the next release, if you wish.
  26. -----------------------
  27. FIRST:
  28. I would like to extend my thanks to my beta-testers: 
  29. Akif Eyler, Amit Parghi, Bill Walker, David Hull, Keith Cummings, Jerry Wilcox, Pat McClaughry, Murph Sewall, Adam Engst, Alberto Ricci, Brian Gordon, A.K.Burton, John Brewer, and Steve Goldberg.
  30. (I hope I'm not forgetting anyone...)
  31.  
  32. TrashMan is straightforward and easy to use because I made it that way.   Although it looks simple, it is 2491 lines of code at last count.  Please give me an incentive to keep writing useful software by registering your copy of TrashMan.  Is $10 that much to ask?
  33.  
  34. -------------------------
  35. NEWS
  36. Version 4.0.5
  37. • Good news!  I have discovered a way to determine whether the disk in a Powerbook is spinning, so now TrashMan can finally be labelled 'PowerBook Friendly'.  TrashMan will not spin up the disk to delete a file, it will wait until the disk is spun up at some later time and then do its work.
  38. However, this feature will only be available to you if one (or both) of the following is true:
  39.     a) You have a relatively 'new' PowerBook (I know the Duos support it, I am told the 145B doesn't, and I think all the higher numbered PB's since the 160 do.)
  40.     b) You have PowerBook File Assistant installed.
  41. • TrashMan now _really_ works if you have AppleScript installed.  (I actually fixed this bug in the Engine in 4.0.4, but overlooked fixing it in the Emptier)
  42. -------------------------
  43.  
  44. WHAT IS TRASHMAN?
  45. • TrashMan is a system enhancement designed for System 7 and beyond.  (TrashMan will not work with System Software prior to 7.0)
  46.  
  47. •TrashMan works like an electronic compost heap, deleting files from your trash after they have 'aged' beyond a setpoint that you specify, in days, hours, and minutes.  (For example, I keep mine set at 1 day, so I always have exactly the last 24 hours worth of trash in my trashcan.)  TrashMan works with all local mounted volumes except floppies.  *(see below)
  48.  
  49. • If you use TrashMan, you need never choose ‘Empty Trash’ from the ‘Special’ menu ever again, and yet still receive the benefits of the new non-emptying trash in System 7.0.
  50.  
  51. -------------------------
  52. HOW DO I SET UP TRASHMAN?
  53. • Place the TrashMan Emptier on your desktop.  It is easiest if it is near your disk icons.
  54.  
  55. • Drop the TrashMan Controls and the TrashMan Engine onto your System Folder.  They will be routed to the correct place. (The Controls are a Control Panel, and the Engine is an Extension).
  56.  
  57. • Open your Control Panels Folder.  Open the TrashMan Controls icon and set your preferences.
  58.  
  59. • You are done.  The next time you restart, the Engine will launch and you are in business.
  60. -------------------------
  61. OK, DAN, I’VE SET IT UP LIKE YOU DESCRIBED. NOW WHAT DO I DO WITH IT?
  62.  
  63. Go back to the TrashMan Control Panel.  Here’s what each of the controls do in more detail:
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84. •The top set of controls allow you to adjust the length of time files will be allowed to stay in the trash before being deleted.  Clicking the up or down arrows increases or decreases the units of time.  Checking the 'Delete locked items too' checkbox gives TrashMan permission to delete items from the trash that are locked.  (An item can be locked by selecting it, and choosing 'Get Info...' in the Finder, then checking the 'locked' checkbox.)
  85.  
  86. •The bottom control allows you to change the ejecting behavior of the Emptier.  If the checkbox is checked, volumes that are dropped on the Emptier will be unmounted and ejected after their trash is emptied.  This works with all volumes, except those that are shared.  Note that the use of the option key when dropping a volume temporarily reverses the sense of this setting.
  87.  
  88. -------------------------
  89. OK, I UNDERSTAND THAT THE ENGINE TIME-STAMPS AND DELETES OLD FILES.  BUT WHAT DOES THIS GOOFY ‘EMPTIER’ THING DO?
  90.  
  91. The Emptier can be thought of as a selective Empty Trash command.  Any disks that you drop onto it will have their trash emptied completely.  All other disks will be left alone.  This is especially handy for dealing with floppies, since it is often the case that you want to erase all the trash from a floppy before ejecting it.  Using the Emptier, this is a one-step operation, since you can have the Emptier eject it afterwards.
  92. Note that holding down the option key while dropping the disk will temporarily reverse this setting.
  93.  
  94. -------------------------
  95. WELL, IT SOUNDS NICE, BUT I DON’T WANT ANOTHER EXTENSION IN MY SYSTEM FOLDER.
  96.  
  97. Although the TrashMan Engine _appears_ to be an extension (an INIT) it is not, in the normal sense.  It is a faceless background application, with a special type, so that the Finder treats it as an Extension.  TrashMan does NOT patch any traps, or have any INIT code in it.  It is simply a program like any other, and therefore has no chance of conflicting with other extensions.
  98.  
  99. -------------------------
  100. WHY DID YOU WRITE TRASHMAN?
  101.     The trash can on the desktop is a wonderful idea, except that I found myself doing something that I’m sure many of you do also:  I would drop something in the Trash, and then immediately go to the Special menu and choose ‘Empty Trash’.  Why?  Because I, like many of you, run at near capacity on my hard disks, and always want to have as much free space as possible.
  102.     The new trash can in System 7.0 is a much improved version of its ancestors, but introduces new problems.  It is wonderful that the Trash no longer empties unexpectedly, but now if you don’t choose ‘Empty Trash’ periodically, it will accumulate many files, wasting valuable disk space.  So what happens?  I choose ‘Empty Trash’ more often!  Although this isn’t bad, it negates the reason that the new non-emptying Trash was developed:  so that when you throw something in accidentally, you can retrieve it later! 
  103.     It seems that what is needed is a program that automatically empties the Trash.  However, if it just empties everything every time you run it, it will be no more useful than the ‘Empty Trash’ command.   What is really needed is a ‘Smart’ trash.  One that doesn’t throw away everything in the trash, just the files that have been there a ‘long’ time.  (And I want to be able to decide what ‘long’ means.)  After over 23 years of painstaking research, I have developed TrashMan.  (Well, OK, it wasn’t quite that long).
  104.  
  105.  
  106. --------------------------
  107. MORE QUESTIONS ABOUT TRASHMAN
  108. --------------------------------
  109. WILL TRASHMAN SLOW DOWN MY COMPUTER?
  110. TrashMan uses only a little RAM, and is configured to be an extremely, EXTREMELY low-priority process, because my intention is for TrashMan to have as little effect on the performance of your Mac as possible.  
  111.  
  112. ARE THERE ANY CONFLICTS WITH ANY OTHER WIDGETS?
  113.     None that I know of, and since the Engine is NOT an INIT, the possibility is very small.
  114.  
  115. WILL TRASHMAN FIND THE TRASH IF I HAVE RENAMED IT TO SOMETHING ELSE?
  116.     (You mean like 'Slime Pit'?)
  117.     YES.
  118.  
  119. COULD TRASHMAN SOMEHOW DELETE FILES THAT ARE NOT IN THE TRASH?
  120. ABSOLUTELY NOT.  
  121.  
  122. MIGHT TRASHMAN DELETE SOMEONE ELSE'S FILES FROM A FILESERVER?
  123.     NO, TrashMan doesn’t time-stamp or automatically delete trashed files from a server, since they are all deleted when you disconnect from the server anyway.
  124.  
  125. WHEN MIGHT TRASHMAN NOT WORK?
  126.     TrashMan will not work with versions of the System earlier than 7.0.
  127.     TrashMan never touches files on servers, to keep down net traffic, 
  128. and because server trash is emptied when you disconnect.
  129.     TrashMan doesn’t touch files on floppies either, since they do not have a Desktop Database. (This is so that they are compatible with Macs running system 6.  In the future, if Apple develops new larger floppy drives, TrashMan will work correctly with them)
  130.  
  131. WOULD TRASHMAN WORK WELL ON A SERVER?
  132.     YES YES!!  TrashMan would be ideal to use on a fileserver, because it would limit how long users could let files accumulate in their trash, wasting space on the server.
  133.  
  134.  
  135. HOW DOES TRASHMAN WORK?
  136. The TrashMan Engine incrementally scans the files in the trash continuously.  When it finds a file it has never seen before, it 'time stamps' it by writing a code in the 'Get Info' comment field.  When it finds a file that has been there longer than the maximum age allowed, it deletes it.
  137.     This means that you will lose any comments that you have attached to files when you throw them in the trash.  This is probably insignificant, since we are all used to losing the darn things every time we rebuild the desktop anyway.
  138.  
  139. ACKNOWLEDGMENTS
  140.     Thanks again to my beta-testers, especially John Brewer, who assisted me on some late-night bug-stomping expeditions.  
  141.  
  142.  
  143. DISCLAIMER
  144. (Sorry about this, but I have to C.M.A.)
  145.     Although TrashMan has been tested heavily and no problems have been found, I do not have the resources to test it under every conceivable condition.
  146.     This means that you use TrashMan ‘as-is’, and at your own risk.  I TAKE NO RESPONSIBILITY FOR ANY LOSS OF DATA THAT MIGHT OCCUR, and by using this software, you agree to these conditions.
  147.  
  148.  
  149. Public Service Announcement:
  150. TrashMan doesn't throw away your files.  It recycles them.
  151.  
  152. DAW 93
  153.       ---------------------------
  154.                VERSION HISTORY
  155.       ---------------------------
  156. Version 4.0.4
  157. • Removed the Speed controls in the Control Panel.  As long as the speed was set below a certain value, there was very little change in performance, so it is now set low enough permanently.  This reduces the complexity for first-time users too.
  158. • TrashMan now works if you have AppleScript installed.  (I was handling a Gestalt call incorrectly, so when AppleScript was installed, TM thought AppleEvents weren't)
  159. • A very rare launch bug should now be gone.  (A very few people couldn't restart the Engine from the control panel after it had been stopped.)
  160. • PowerBook performance has been tweaked again.  Now the Engine will not wake up and check the trash unless the mouse has been moved recently.  Until I can find a way of determining whether the disk is spinning, this will have to do.
  161. ------------------------------
  162. Version 4.0.3
  163. • In previous versions, if there were things in the trash, TrashMan could prevent PowerBooks from going to sleep.  This has finally been eliminated.  I also changed the speeds in the control panel.  They have all been shifted 'slower'.
  164. ------------------------------
  165. Version 4.0.2
  166. • Fixed an even more obscure bug, involving files on servers and concurrency, by having the Engine ignore trash that you drop on a server.  It is emptied when you disconnect anyway, and this reduces network traffic.
  167. ------------------------------
  168. Version 4.0.1
  169. • Fixed obscure bug.  A long integer was being clipped to a short by mistake.  Unfortunately, this was an IMPORTANT long integer.  (Maybe I should throw in a few unneeded variables in my programs, so that the chance of an important one being affected is smaller.  hahahaha)
  170. • Added some more error checking (you can never have enough of that...) and changed the text in some error dialogs to be more descriptive.
  171. ------------------------------
  172. Version 4.0.0
  173. • Completely rewritten from scratch.  New incremental scanning algorithm, which is undetectable in normal operation.  No more pauses as TM scans your trash!
  174. • Split into 3 parts, so as to minimize memory usage.
  175. • Pretentious 3D animated 'About Box' and gratuitous sounds added to control panel.
  176. • Controls are simpler.  TrashMan is even _easier_ to use.
  177. ------------------------------
  178. (Previous version info deleted to save space.  It is irrelevant now anyway, since the program works completely differently)
  179. (The end)